home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / internet / ftpmon10.zip / FTPMON.TXT < prev    next >
Text File  |  1996-01-29  |  8KB  |  174 lines
  1. FTPMon 1.0 for OS/2
  2.  
  3. DESCRIPTION
  4. ---------------------------------------------------------------------
  5. I wrote FTPMon so that I could scan the incoming directory of an
  6. anonymous FTP site and not have to look through a lot of old files
  7. to see what was new.  FTPMon maintains a list of all the files in the
  8. incoming directory of a site, but displays only those that you have
  9. not seen previously.  Once you see a file in the list, you can download
  10. it, view it, or tag it as boring.  Downloaded and boring files are
  11. removed from the list (but not, of course, the FTP site), and don't
  12. appear there again.  FTPMon will refresh the list once an hour, or at
  13. the request of the user.
  14.  
  15.  
  16. COPYRIGHT AND DISTRIBUTION
  17. ---------------------------------------------------------------------
  18. See the file README.1ST for copyright and distribution information.
  19.  
  20.  
  21. HOW TO USE FTPMon
  22. ---------------------------------------------------------------------
  23. Install FTPMon according to the directions in README.1ST.  Double-
  24. click on the "FTP Monitor" program object to start FTPMon.
  25.  
  26. _First time startup_
  27.  
  28. The first time you run FTPMon, you will see a Quick info... screen
  29. describing the next two dialogs you will see.  Double click on the title
  30. bar icon to continue.  You will then be asked for your e-mail address.
  31. The e-mail address is used to set your initial password for anonymous
  32. logins. You will then asked to create a site file.  A site file holds the
  33. information needed to connect to a specific site as well as the list of
  34. files you've already seen. You may create or switch to another site file
  35. by selecting the 'Site File...' option from the 'Options' menu.
  36.  
  37. _Using FTPMon_
  38.  
  39. Once the first time startup information is entered, you will see the
  40. FTPMon main window.  It will look something like this (best viewed
  41. with a monospaced font):
  42.  
  43. .__________________________________________________________________.
  44. |\/| New Files - HOBBES                                            |
  45. |__________________________________________________________________|
  46. |Options                                                           |
  47. |__________________________________________________________________|
  48. |.________________________________________________________________.|
  49. ||                                                             |/\||
  50. ||                                                             |  ||
  51. ||                                                             |  ||
  52. ||                                                             |\/||
  53. |+________________________________________________________________+|
  54. |.________________________________________________________________.|
  55. || hobbes.nmsu.edu/incoming                                       ||
  56. |+________________________________________________________________+|
  57. | Download Directory                                               |
  58. |.________________________________________________________________.|
  59. || C:\TMP                                                         ||
  60. |+________________________________________________________________+|
  61. |.______________.         .______________.         .______________.|
  62. ||   Download   |         |     View     |         |   Boring!    ||
  63. |+______________+         +______________+         +______________+|
  64. |.________________________________________________________________.|
  65. ||                           Update Now                           ||
  66. |+________________________________________________________________+|
  67. +__________________________________________________________________+
  68.  
  69. The FTPMon window consists of the following parts:
  70.  
  71. (1) An Options menu, which is described later.
  72.  
  73. (2) A list box.  The list box will eventually contain a list of files
  74. at an FTP site.
  75.  
  76. (3) An entry field.  In entry field, enter the name of the
  77. FTP site you're interested in and the directory you want to
  78. monitor in the format <site>/<directory>.  For example, hobbes's
  79. incoming directory would be 'hobbes.nmsu.edu/incoming' and CDROM's
  80. incoming directory would be 'ftp.cdrom.com/pub/os2/incoming'.
  81.  
  82. (4) Another entry field, under the Text "Download Directory".  Enter
  83. the drive and directory on your computer where you want the files
  84. you download to go.
  85.  
  86. (5) Four pushbuttons: Download, View, Boring!, and Update Now.
  87.  
  88. To download files in the list to the directory in the Download
  89. Directory entry field, highlight all the files in the list you want to
  90. download and push the Download button.  Multiple files may be selected
  91. via ctrl-click and (if the files are sequential) shift-click in the
  92. list box.  After downloading a file, it is removed from the list
  93. automatically.  You will not see those files in the list again.
  94.  
  95. To view files text files in the list, highlight the files you
  96. want to view and push the View button.
  97.  
  98. To remove files from the list without downloading them, highlight the
  99. files you want to remove and push the Boring! button.  You will
  100. not see those files in the list again.
  101.  
  102. To update the list by re-scanning the FTP site, push the Update Now
  103. button.  FTPMon will then connect to the FTP site, get a list of files
  104. in the desired directory, disconnect from the FTP site, and update the
  105. list.  Note that updating the list involves adding files that you have
  106. never seen to the list as well as removing files from the list that
  107. are no longer there.  **If a file was removed from the list because
  108. you downloaded it or because you said it was Boring!, it will NOT
  109. reappear.**
  110.  
  111. The list is updated automatically every hour.
  112.  
  113. _The Options menu_
  114.  
  115. The options menu has the following items:
  116.  
  117. (1) Login info...  This selection brings up a window that lets you
  118. enter the username and password you want to use.  The defaults are
  119. "anonymous" and your e-mail address.  These fields are stored in the
  120. site file so they will not interfere with your username/password for
  121. any other site.  THE PASSWORD IS NOT ENCRYPTED IN THE SITE FILE.  IT
  122. IS NOT PROTECTED IN ANY WAY.  USE AT YOUR OWN RISK.
  123.  
  124. (2) Email (email address)...  This option allows you to change your
  125. e-mail address.  The current e-mail address is displayed.
  126.  
  127. (3) Site file...  This option allows you to create or to switch to
  128. another site file.  All information for the current file is saved
  129. before opening the new file.
  130.  
  131. (4) Other... The only field currently on the Other Options window
  132. allows you to set the program started to View files.  The default
  133. is 'E', the OS/2 system editor.
  134.  
  135. (5) Age file... Aging a site file means removing old 'downloaded' and
  136. 'boring!' entries from it.  Aging a file currently takes a long time.
  137.  
  138.  
  139. KNOWN BUGS/LIMITATIONS
  140. ---------------------------------------------------------------------
  141. No true bugs are known.  FTPMon does have these limitations:
  142.  
  143. (1) Viewed files are downloaded to the directory pointed to by the
  144.     TMP environment variable.  The user is responsible for deleting
  145.     these files.
  146. (2) Aging a site file takes much too long.
  147. (3) Filenames are case sensitive.  If a file appears on the site twice,
  148.     once uppercase and once lowercase, the file will appear in the list
  149.     twice.
  150. (4) No checking is done to insure that a file Viewed is a text file.
  151. (5) Only a file's name is used when deciding if a file has been in
  152.     the list before.  If a file is uploaded to the FTP site, made Boring!,
  153.     removed from the FTP site, and another file with the same name is
  154.     uploaded to the FTP site, it will not appear in the list.  Aging the
  155.     site file should help lessen this problem.
  156.  
  157.  
  158. POSSIBLE ENHANCEMENTS FOR FUTURE VERSIONS
  159. ---------------------------------------------------------------------
  160. The following is a list of enhancements that may appear in future
  161. versions of FTPMon.  If you have any other ideas for enhancements,
  162. please e-mail them to abbott@hiwaay.net.
  163.  
  164. (1)     Speed up aging of site files.
  165.  
  166. (2)     Rather than deleting a file from the list after the user
  167.         downloads the file or selects "Boring!", leave the file in the
  168.         list but change the color.  This would also eliminate all aging
  169.         problems, as aging would no longer make sense.
  170.  
  171. (3)     Automatically delete Viewed files when the user exists the
  172.         program.
  173. 
  174.